package com.huyanqi.core.service;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;

import com.huyanqi.core.BaseDomainObject;
import com.huyanqi.core.RetdObj;
/**
 * 
 * <p>Title: BaseRestService.java</p>
 * 
 * <p>Description: Rest Service 基类</p>
 * 
 * <p>Datetime: 2011-12-26 上午11:33:16</p>
 *
 * @company 成都映潮科技有限公司
 * 
 * @author <a href="mailto:liwei@sunsharp.cn">p.k.ripper</a>
 *
 */
public interface BaseRestService<Entity extends BaseDomainObject,PK extends Serializable> {
	/**
	 * 增加实体
	 * 
	 * @param entity
	 * @return
	 */
	public RetdObj<Entity> save(Entity entity);

	/**
	 * 更新实体
	 */
	public RetdObj<Entity> update(Entity entity);	

	/**
	 * 按ID删除对象
	 * 
	 * @param id
	 */
	public RetdObj<Entity> delete(final PK id);
	
	/**
	 * 按对象删除
	 * 
	 * @param id
	 */
	public RetdObj<Entity> delete(Entity entity);

	/**
	 * 按ID查询对象
	 * 
	 * @param id
	 * @return
	 */
	public RetdObj<Entity> findById(final PK id);

	/**
	 * 按ID查询多个对象
	 * 
	 * @param ids
	 * @return
	 */
	public RetdObj<List<Entity>> findByIds(final Collection<PK> ids);
	/**
	 * 根据NameQuery查询
	 * @param queryName
	 * @param parameters
	 * @return RetdObj<List<Entity>>
	 */
	public RetdObj<List<Entity>> findAllByNameParams(String queryName, Object... parameters);
	
	/**
	 * 根据属性查询
	 * @param propertyName
	 * @param value
	 * @return RetdObj<List<Entity>>
	 */
	public RetdObj<List<Entity>> findByProperty(String propertyName, Object value);

	/**
	 * 根据多个属性查询
	 * @param values
	 * @return RetdObj<List<Entity>>
	 */
	public RetdObj<List<Entity>> findByProperty(Map<String, Object> values);
}
